home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 February / Macworld (1998-02).dmg / Games World / Shareware Games / Cards / Alan’s Solitaire 1.0.3 / Read Me next >
Text File  |  1997-11-29  |  7KB  |  155 lines

  1. This game is shareware. Please send $2, or whatever you think it's worth, to the address below. This game may not be re-distributed without written permission from the author.
  2.  
  3. If you would like the source code please send your email address and $20 to the address below! 
  4.  
  5. Alan Ewalt
  6. Ewalt Enterprises, Inc.
  7. 4780 Lage Dr.
  8. San Jose, CA 95130
  9.  
  10. This version of the game is PowerPC only. I have not yet compiled a 68k version of the game. If you want a 68k version let me know, email me at aewalt@aol.com.
  11.  
  12. -----------------
  13. Release  notes:
  14. -----------------
  15. 1.0.3 - Nov. 29 '97
  16. Fixed a bug that occurred when loading and saving prefs when launching the application from a volume other than your startup drive.
  17.  
  18. 1.0.2 - Nov. 25 '97.
  19. Fixed a redraw problem.
  20. Fixed a bug that occured if you clicked the deck after undoing one move back from a loss.
  21.  
  22. 1.0.1 - not released
  23. Rewrote SavePrefs and LoadPrefs procedures to fix bug with non-english script systems.
  24.  
  25. 1.0 - Nov. 9 '97.
  26. Initial release. 
  27.  
  28. -----------------------------------------------------
  29. Online help text follows, found under help menu:
  30. -----------------------------------------------------
  31.  
  32. Object of the game:
  33.  
  34. The object is to remove all of the cards from the board.
  35.  
  36. You win when all cards have been removed from the board.
  37.  
  38. You loose when all cards have been dealt from the deck and there are still cards remaining on the board.
  39.  
  40. Be forewarned, wins are rare! On average you will win only about 5% of the games you play.
  41.  
  42. Rules of the game:
  43.  
  44. The card at the top right of the window is referred to as the Play Card. Cards are dealt onto the board in the shape of a pyramid and are referred to as Board Cards.
  45.  
  46. A Board Card is only playable if it is uncovered.
  47.  
  48. A Board Card is only playable if it is one up, or one down, in sequence from the Play Card. For example, if the Play Card is a 5, you can play a 4 or a 6 from the uncovered cards on the board.
  49.  
  50. Change the Play Card by taking a Hit or playing a card from the board. The Hit card or board card played becomes the new Play Card.
  51.  
  52. By default Aces are both high and low. So, you can play an Ace on a King or a 2. You can change Ace behavior by setting your preferences.
  53.  
  54. Suit is ignored.
  55.  
  56. Rules and features of the application:
  57.  
  58. To begin a game select New Game from the File menu. Or, click Deal on the game window.
  59.  
  60. You can re-deal as many times as you like until you take your first hit card or play your first card from the board.
  61.  
  62. Play a card from the board by clicking it. 
  63.  
  64. The Hit button changes the Play Card by dealing the next card from the deck. You can also click the Card Deck.
  65.  
  66. You can have multiple game windows open at once by selecting New from the File menu. 
  67.  
  68. Command + d with a game window front most will deal (if a deal is allowed).
  69.  
  70. Auto Play
  71. Pressing the space bar with a game window front most will activate Auto Play. Auto Play will play the game automatically for you until there is more than one playable card to choose from. You may decide what you want to happen at this point by setting your "Auto play decision" preference. You may decide how much time to delay between auto play moves by setting your "Auto play delay (in ticks)" preference. I find anything over about 30 annoying, range is 0 to 300.
  72.  
  73. Players & High Scores (Edit Menu)
  74. Up and down arrow keys select a row.
  75. Special characters in front of the player name have special meanings as follows:
  76.     • denotes the default player, the player to use when you launch the game.
  77.     * denotes the active player, the player currently playing. I added this in case someone else comes along and takes your Mac!
  78. Change Name 
  79.     - changes the player name (command + n)
  80. Make Default 
  81.     - changes the selected player to the default player (command + d)
  82. Make Active 
  83.     - changes the selected player to the active player (command + a)
  84. Clear... 
  85.     - clear the selected player's scores and name!
  86. Clear All... 
  87.     - clears all of the player's scores and names! (command + c)
  88. Save & Show Scores 
  89.     - save any changes and shows the selected player's scores.
  90.  
  91. Preferences
  92. Auto play delay (in ticks) 
  93.     - see Auto Play above, 1 tick = 1/60th of a second
  94. Auto play decision 
  95.     - see Auto Play above
  96. Ace behavior 
  97.     - see Rules of the game
  98. Unplayable card behavior 
  99.     - this determines what happens when you click a card that is either covered or not in sequence from the Play Card
  100. Give hints 
  101.     - if checked and you take a Hit when there is a playable card on the board you will get a dialog that asks if you want to see the card you missed, stop (in order to figure it out yourself), or continue without a hint (kind of dumb thing to do!)
  102. Allow undo
  103.     - enables the undo command in the edit menu. You can back up to the beginning of the game at any time. After losing, it's kind of cool to hold down command + z and watch the game go backwards. It's also useful to see what's happened after a lengthy auto play.
  104. Play card sounds
  105.     - plays a sound when you take a hit or play a card from the board and when dealing
  106. Deal on new game
  107.     - will deal automatically when selecting new game
  108. New game on startup
  109.     - will select New Game when you open the game
  110. Show default player's scores at startup
  111.     - will do just that!
  112.  
  113. Alert Dialogs
  114. The space bar, return and enter keys all answer default in dialogs. The addition of the space bar as a default key makes auto play a little easier when auto play decision is set to Alert Dialog.
  115.  
  116. Known problems & stuff in progress:
  117.  
  118. I don't like the way redraws of cards are handled, it flashes and is ugly. I'm planning to use CopyBits, instead of on screen redraws.
  119.  
  120. I want to add dragging of the cards to the Play Card area, instead of just a click. Or, better yet, I'd like to add that cool thing Eric's Solitaire does where you can throw the card and it goes to where it's supposed to.
  121.  
  122. I want to add the ability to play a card by typing 1 through 7 (no command key). 1 will always play the furthest left playable card, whichever row that may be. 2 will play the second from the left, etc.
  123.  
  124. I also want to add look ahead to auto play. When auto play reaches a point where there are multiple cards to play it stops. This is dumb. I'm going to add a preference that allows you to look at various outcomes of removing any one of the removable cards.
  125.  
  126. By the time you send in your shareware fee, all this stuff should be completed.
  127.  
  128. Please let me know if you have other suggestions.
  129.  
  130. Photo Credits
  131.  
  132. Option + About Solitaire
  133. by Naoko
  134.  
  135. Shift + About Solitaire
  136. by Alan
  137.  
  138. Shareware & other stuff:
  139.  
  140. This game was written in C using Metrowerks CodeWarrior Professional.
  141.  
  142. I don't remember who taught me this game. I learned it when I was quite young and always liked it a lot. The simplicity and the fact that you hardly ever win kept me interested.
  143.  
  144. If you have any suggestions, bug reports, feature requests, or whatever please send them to me at aewalt@aol.com. Please mention Solitaire in the subject or I may delete it without reading it (damn spam!).
  145.  
  146. This game is shareware. Please send $2, or whatever you think it's worth, to the address below. This game may not be re-distributed without written permission from the author.
  147.  
  148. If you would like the source code please send your email address and $20 to the address below! 
  149.  
  150. Alan Ewalt
  151. Ewalt Enterprises, Inc.
  152. 4780 Lage Dr.
  153. San Jose, CA 95130
  154.  
  155. Please support shareware!